Repository navigation
スプリント issue-514 - #518
スプリント issue-514#518
Conversation
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
プラグインリポジトリの定義(0 件でもよい)を plugin-yml-reference に入れる。 用語集の 3 語は設計の工程で入っており、glossary.md は render --check で一致している。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
作成フローのプラグイン名とプロジェクト名の確認、`project new` のグループの案が 名前の規則を使うので、確定仕様の使う場所と走査の表へ足す。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
#514 を実装する(スプリント issue-514)
改修計画 — devbasex/devbase #518
改善項目I-001 —
|
| 兆候 | 手法 | 重要度 | 等級 | 提案元 | 状態 | コミット |
|---|---|---|---|---|---|---|
| long_method | extract_method | major | high | claude / codex | 見送り | 1 |
なぜ: 1 関数に clone の確認・pull 前のスナップショット・registry.yml の読み直し・消えた plugin の警告・導入済み plugin の更新と失敗の報告が通しで入る。ファイルで最長で、CC も範囲内で最大。PluginError を RepositoryError へ変える同じ try も 2 回続く。作成フローの _apply_locally もこの関数を呼ぶ
手順: 1. TestRefreshRepository と TestRefreshWithPrePullSnapshot を変更前に実行する。
2. 登録取得から clone_dir.is_dir の判定までを、registry と name を受けて repo と clone_dir を返す内部関数へ抽出する。例外型と文面はそのまま移す。
3. old/new/installed の名前集合から削除警告を出す部分を、repo・plugins・installed を受ける内部関数へ抽出する。警告のソート順と文面を保つ。
4. 元の関数に更新手順を残し、snapshot → pull → 解析 → 警告 → 保存 → 更新 → 同期の順序、例外変換、sync=False の扱いを変えず既存テストを実行する。新しい関数の本体・引数の受け渡し・呼び出しを見積りに含む。
取り消した理由: 実装の終わりまでにコミットが無く、残った時間に入らない
指標の測定
- 状態: written / 言語とツールの対応: 既定(.ndf/code-metrics.json は無い) / 所要: 31.0 秒(使えた時間 90 秒 / 上限 90 秒)
- 指標のファイル: /tmp/ndf-worktrees/devbasex--devbase/rf518/work/.cross_refactoring/code-metrics-rf518.md
| 言語 | ツール | 版 | ランナー | ファイル | 秒 | 結果 |
|---|---|---|---|---|---|---|
| python | ruff-complexipy | ruff 0.16.9 / complexipy 8.0.1 | uvx | 231 | 1.3 | 測った |
| shell | — | — | — | 1 | — | unsupported_language |
| 重複: python | symilar | pylint 4.0.9 | uvx | 231 | 23.3 | 測った(1 箇所) |
| 重複: shell | jscpd | jscpd 4.3.0 | npx | 1 | 5.5 | 測った(0 箇所) |
時間の上限
| 値 | 中身 |
|---|---|
| 提案の枠の終わり(監視の上限 = 残り + 余裕) | 2026-11-06T03:17:49+00:00 |
| 改修計画の枠の終わり(同上) | 2026-11-06T03:20:49+00:00 |
| テストの追加の終わり = 実装の終わり − Σ(採っていて未検証の項目の実装の見積り) | 2026-11-06T03:24:06+00:00 |
| 実装の終わり = 最終ゲートの修正の打ち切り − バッファ − Σ(採っていて未検証の項目の検証の見積り) | 2026-11-06T03:25:24+00:00 |
| 直しの試行の打ち切り | 2026-11-06T03:31:06+00:00 |
| 想定最大時間の終わり H(子プロセスはすべてここまでに止まる) | 2026-11-06T03:39:13+00:00 |
| 確かめの開始の締め切り = H − 確かめの見込み(最終ゲート修正と打ち切りの後の取り消しもここまで) | 2026-11-06T03:36:36+00:00 |
| 確かめの見込み(秒。最終ゲートの確かめ 1 回。バッファの最終ゲートの全体テスト) | 157 |
| 最終ゲート修正 1 回の見込み(秒。バッファの final_fix。起動は今 + この値が確かめの開始の締め切り以前のときだけ) | 330 |
| 指標の測定の上限(秒。提案の枠の中から割く) | 90 |
| 着手前のテスト 1 回の上限(秒) | 449 |
| 範囲テスト 1 回の上限(秒) | 469 |
| 手元の全体テスト 1 回の上限(秒) | 190 |
| CI の待ちの上限(秒) | 246 |
| 余裕(秒。手順の上限と CLI の上限に足す) | 90 |
入力: 予算 30 分 / 全体テストの所要 w 63.1(ndf-record) / 着手前の実測 x 156.2 / CI の壁時計 c 82.0 / 着手前のテストの所要の見込み s 149.4(recent) / 戦略 local-full
無音の打ち切りは手順の監視の上限と同じ値である。項目ごとの期限は持たない(実装を止めるのは実装の終わりだけ)。
見送った提案
| 対象 | 兆候 | 理由 | 根拠(MVV) | 補足 |
|---|---|---|---|---|
lib/devbase/commands/plugin.py#cmd_plugin_new |
duplication | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/cli.py#_dispatch |
conditional_chain | budget | Vision | 見積り 4.2 分が残りに入らない |
lib/devbase/tui/actions_plugin.py#_run_repo_operation |
dead_code | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/commands/project.py#cmd_project_migrate_config |
long_method | budget | Vision / Mission / Value 2 | 見積り 4.2 分が残りに入らない |
lib/devbase/commands/project.py#cmd_project_new |
divergent_change | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/cli.py#_add_shortcuts |
duplication | budget | Mission / Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/plugin/creator.py#_inspect |
data_clump | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/plugin/publish.py#push_initial |
duplication | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/plugin/repo_manager.py#_pull_ff_only |
duplication | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/tui/actions_plugin.py#_select_operation |
inconsistent_naming | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/plugin/creator.py#CreationPlan.describe |
conditional_chain | budget | Vision | 見積り 4.2 分が残りに入らない |
lib/devbase/plugin/repo_manager.py#_reject_duplicate_registration |
duplication | budget | Vision / Value 3 | 見積り 4.2 分が残りに入らない |
tests/containers/test_base_shellcheck_ci.py#_shellcheck_commands |
deep_nesting | budget | Vision | 見積り 1.5 分が残りに入らない |
tests/volume/test_compose_secret_env.py#_clear_devbase_env |
duplication | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/cli.py#_add_plugin_parser |
duplication | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/cli.py#_expand_argv |
scattered_config | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/commands/project.py#cmd_project_migrate_volume |
long_method | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/plugin/creator.py#suggest_group |
duplication | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/plugin/github.py#GhClient._wait_mergeable |
magic_value | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/plugin/publish.py#publish_change |
long_method | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/plugin/repo_manager.py#_find_registered |
inconsistent_naming | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/plugin/scaffold.py#_insert_entry |
duplication | budget | Vision | 見積り 1.5 分が残りに入らない |
tests/plugin/creation_harness.py#FakeGitHub |
duplication | budget | Vision | 見積り 1.5 分が残りに入らない |
tests/plugin/test_create_repo.py#_plugins_yml |
duplication | budget | Vision | 見積り 1.5 分が残りに入らない |
lib/devbase/plugin/repo_manager.py#show_repositories |
deep_nesting | budget | Vision | 見積り 4.2 分が残りに入らない |
lib/devbase/plugin/repo_manager.py#refresh_repository |
long_method | not_done | Value 2 / Vision | 実装の終わりまでにコミットが無く、残った時間に入らない |
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 1 | claude | REQUEST_CHANGES
major 4 件。うち 2 件(組織の権限の判定、登録の URL の形)は、偽の gh と insteadOf のテストの土台が実の GitHub と違う形で通すため、テストでは見つからない。実の応答に合わせて土台も直す。外部の確認は取得 5 回(gh api 3 回、GitHub の OpenAPI の説明の取得 2 回。2026-11-06)で上限内。非管理者のメンバーとしての実の応答は取得できず、OpenAPI の記述と非メンバー・owner の実測から判断した。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 1 | codex | REQUEST_CHANGES
major 3 件の修正が必要です。
- plugin new の registry.yml の PR がマージできないときは、打ち直しを案内する - 組織の members_can_create_repositories が返らないときは判定不能として進める - plugin new・plugin repo new と TUI も機密を注入せず、gh を利用者の設定で動かす - 一時の clone と push は登録の URL で行う - 一時の clone の外を指す書き込みを止める - project new は登録の path が既定ブランチと違えば書き込む前に止める - 取り込みの前にプロジェクト一覧を控えて refresh の移行へ渡す 偽の gh も、組織の設定を owner にしか返さない形へ揃える。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
🔧 /ndf:fix サマリ | round 1 | commit ca80477対応件数: critical=0 / major=7 / minor=0(合計 7 件) |
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 2 | claude | REQUEST_CHANGES
major 2 件。1 件は registry.yml の項目に path が無いプラグインへ project new が別の場所へマージして 0 で終わる不具合、1 件は ca80477 の行の挿入で「上の行に同じ」の指す先が変わった設計の表である。設計 issues/issue-514-design.md は読み、新しい依存と設計に無い自前の部品は無かったので、外部の取得は行っていない(0 回)。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 2 | codex | REQUEST_CHANGES
major 2 件の修正が必要です(範囲の 33 ファイルと #514 の設計を確認、外部取得 8 回、テスト未実行)。
- registry.yml の項目に path が無いプラグインを導入と同じく直下として扱う - gh の操作先を GH_HOST で github.com に固定する - clone の既定ブランチを GitHub の値と比べ、書き込みの前に止める - 設計の途中で止まったときの表の案内を実装に揃える Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
🔧 /ndf:fix サマリ | round 2 | commit bec38cf対応件数: critical=0 / major=4 / minor=0(合計 4 件) |
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 3 | claude | REQUEST_CHANGES
major 1 件。gh pr merge の終了コード 0 をマージ済みと見なしているため、マージキューのあるブランチでは未マージのまま手元の登録へ進む。設計 issues/issue-514-design.md は読み、新しい依存と設計に無い自前の部品は無かった。外部の取得は 1 回(https://cli.github.com/manual/gh_pr_merge、2026-11-06 取得)で上限内。テストは実行していない。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 3 | codex | REQUEST_CHANGES
major 1 件の修正が必要です(範囲の33ファイルと#514の設計を確認。外部取得1回、テスト未実行)。
`app-` のような名前は名前の形の検査を通るが、そのまま `app-:latest` を 書くと build と up が invalid reference format で止まる。 名前の検査は変えず、イメージ名を作るときに整える。末尾の区切り文字を 落とし、英数字の間に置けない区切り文字の並びを `-` にする。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
🔧 /ndf:fix サマリ | round 3 | commit 0ec1696対応件数: critical=0 / major=1 / minor=0(合計 1 件) |
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 4 | claude | REQUEST_CHANGES
major 2 件。どちらも、名前の形を通った名前の後段の失敗である。1 件は project new owner/MyApp や owner/foo.github.io が 0 で終わるのに、できたプロジェクトが Compose のプロジェクト名の規則に合わず devbase up で止まる不具合。もう 1 件は git のブランチ名にできない名前が計画を通り、新規リポジトリを作った後に止まる不具合である。設計 issues/issue-514-design.md は読み、新しい依存と設計に無い自前の部品は無かった。外部の取得は 0 回で、Compose の振る舞いは手元の docker compose v5.6.1 で確かめた。テストは実行していない。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 4 | codex | REQUEST_CHANGES
major 1 件の修正が必要です(範囲の33ファイルと #514 の設計を確認。外部取得1回、テスト未実行)。
- project new の名前を Compose のプロジェクト名の規則に合わせる。既定の リポジトリ名は形を整え、--name の合わない名前は書き込みの前に止める - 名前の形を通っても git のブランチ名にできない名前は、有効で一意な ブランチ名へ置き換える Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
🔧 /ndf:fix サマリ | round 4 | commit 848847d対応件数: critical=0 / major=3 / minor=0(合計 3 件) |
🔧 /ndf:fix サマリ | commit (なし)対応件数: critical=0 / major=0 / minor=0(合計 0 件) |
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 5 | claude | APPROVE
指摘なし。範囲の 33 ファイルと設計 issues/issue-514-design.md を読み、新しい依存と設計に無い自前の部品は無かった。外部の取得は 0 回。テストは実行していない。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 5 | codex | APPROVE
新規の critical / major 指摘はありません。範囲の33ファイルと #514 の設計文書を確認しました(判断の根拠: Mission・Vision・Value 3)。外部取得0回、テスト未実行。
設計・実装計画・要求の写しを docs/specifications/plugin-creation-flow.md へ まとめ、現在のコードと照合した。用語集の出所を確定仕様へ移し、CLI リファレンスから 確定仕様へのリンクを足す。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MLNyzXBPxRoJnnnHwA7Guz
snapshot create と語を揃える。plugin repo new・plugin new・project new を plugin repo create・plugin create・project create へ改め、コマンドに由来する内部の 名前、作業ブランチの接頭辞 devbase/create-<種類>-<名前>、TUI の副命令の値、補完、 文書、テストを揃える。振る舞いは変えない。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MLNyzXBPxRoJnnnHwA7Guz
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 6 | claude | APPROVE
指摘なし。範囲の 36 ファイルと、この範囲で消えた設計 issues/issue-514-design.md(基点の版)、その移し先の docs/specifications/plugin-creation-flow.md を読んだ。新しい依存と設計に無い自前の部品は無かった。外部の取得は 0 回。テストは実行していない。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 6 | codex | APPROVE
新規の critical / major 指摘はありません。範囲の36ファイルと、確定仕様へ移動した #514 の設計文書を確認しました(判断の根拠: Mission・Vision・Value 3)。新しい依存と設計に無い自前の部品はありません。外部取得0回、テスト未実行。
スプリント issue-514 の課題を main へ取り込む。
利用者向けの変化
devbase plugin repo createで、プラグインのリポジトリを新しく作れる(#514 を実装する(スプリント issue-514) #517)devbase plugin createで、プラグインを新しく作れる(#514 を実装する(スプリント issue-514) #517)devbase project createで、プロジェクトを新しく作れる(#514 を実装する(スプリント issue-514) #517)移行の手順
課題と設計
docs/specifications/plugin-creation-flow.md設計と違う点
repos/の clone の置き場が既にあるときは、確認の前に終了コード 1 で止めるadd_repositoryの拒否でマージの後に止まるのを避けるため(決定 9 と同じ方向)plugin createの登録済みの行)registry.ymlが無い・空のリポジトリは確認の前に終了コード 1 で止めるrepo_manager.pyの既存の関数は変えない)refresh_repositoryにpre_pull_projectsを足し、_require_default_branch・_snapshot_repo_projectsを足した_NO_SECRET_INJECTION)('project', 'new')だけでなく 3 コマンドを足した..・末尾の.・.lockの名前のブランチ名はハッシュを足した形にするコミット
変更の統計
テスト(supervise.py の run のステップ)
集めた実装の PR
閉じる課題
最終工程の後に閉じる: #514
手動確認
devbase listの表示を見る。TUI の見た目もこのときに見るモード: standard / 通した工程: 実装 → Pull Request
🤖 Generated with Claude Code
https://claude.ai/code/session_01MLNyzXBPxRoJnnnHwA7Guz